Skip to main content

Site Settings

Configure your site's settings, access controls, and integrations from a centralized settings panel.

Overview​

Site Settings provides a comprehensive interface to manage all aspects of your site configuration. From basic site information to advanced security settings, roles, and integrations, everything is accessible from a single, organized settings page.

Concepts​

Site Settings Categories​

Settings are organized into categories for easier management:

  • General: Basic site information and configuration
  • Configurations: NavKit, General, Security, and Integration settings
  • Access: Users, Roles, User Attributes, and Social Apps

Site Config​

Key-value configuration pairs that control site behavior. These can be grouped into categories like NavKit, General, Security, and Integrations.

Access Site Settings​

  1. Navigate to your Site in the Dashboard.
  2. Click the Settings tab.
  3. The settings page displays a sidebar with all available sections.

Settings Sections​

Site Info​

View and update basic site information.

  1. Click Site Info in the settings sidebar.
  2. Update the following fields:
    • Site Name: The display name of your site
    • Domain: View the site domain (read-only)
    • Description: Optional description
  3. Click Save Changes.

Status Panel: View current site status, environment, creation date, and organization.

Secret Types​

Manage the types of secrets that can be stored for your site.

  1. Click Secret Types in the settings sidebar.
  2. View existing secret types.
  3. Click Create Secret Type to add a new type.
  4. Configure the secret type:
    • Name: Display name for the secret type
    • Key: Unique identifier
    • Schema: JSON schema defining the secret structure
  5. Click Save.

Configuration Sections​

Configure navigation and UI settings for your site.

  1. Click NavKit in the Configurations group.
  2. View and edit NavKit settings.
  3. Each setting can be edited inline.
  4. Changes are saved automatically.

General Configuration​

Manage general site settings.

  1. Click General in the Configurations group.
  2. Configure key-value settings for site behavior.
  3. Edit values directly in the settings cards.

Security Configuration​

Configure security-related settings.

  1. Click Security in the Configurations group.
  2. Manage authentication and authorization settings.
  3. Configure session timeouts, password policies, etc.

Integrations Configuration​

Manage third-party integrations and API settings.

  1. Click Integrations in the Configurations group.
  2. Configure integration endpoints and credentials.
  3. Enable or disable specific integrations.

Access Settings​

Users​

Manage site-level users and their access.

  1. Click Users in the Access group.
  2. View all users with access to the site.
  3. Search for specific users.
  4. Manage user permissions and roles.

Roles​

Create and manage site-level roles.

  1. Click Roles in the Access group.
  2. View existing roles.
  3. Click Create Role to add a new role.
  4. Configure role permissions.
  5. Assign users to roles.

User Attributes​

Define custom attributes for user profiles.

  1. Click User Attributes in the Access group.
  2. View existing user attributes.
  3. Add new custom attributes.
  4. Configure attribute types (text, number, date, etc.).

Social Apps​

Configure social authentication providers.

  1. Click Social Apps in the Access group.
  2. View configured OAuth providers.
  3. Add new social login providers (Google, GitHub, etc.).
  4. Configure client credentials and scopes.

Danger Zone​

warning

Actions in the Danger Zone are permanent and cannot be undone.

  1. Click Danger Zone in the settings sidebar.
  2. The following destructive actions are available:
    • Delete Site: Permanently remove the site and all data

Delete a Site​

  1. Click Delete Site.
  2. Review the warning about data that will be deleted:
    • All applications and their data
    • Database tables and content
    • File uploads and storage
    • Usage analytics and logs
    • Site configuration and settings
  3. Type the site name to confirm.
  4. Click Delete Site Permanently.

Create Config Setting​

Add new configuration settings to your site.

  1. Navigate to any Configuration section.
  2. Click Create Config.
  3. Fill in the setting details:
    • Category: Select the category (NavKit, General, Security, Integrations)
    • Key: Unique identifier for the setting
    • Value: The configuration value
    • Description: Optional description
  4. Click Create.

Configuration​

Site Info Fields​

FieldDescriptionEditable
Site NameDisplay nameYes
DomainSite domain URLNo
DescriptionSite descriptionYes
StatusActive/InactiveNo
EnvironmentProduction/Staging/DevelopmentNo
CreatedCreation dateNo
OrganizationParent organizationNo

Config Categories​

CategoryDescription
NavKitNavigation and UI configuration
GeneralGeneral site behavior settings
SecurityAuthentication and security settings
IntegrationsThird-party service configurations

Troubleshooting​

Settings not saving​

Problem: Changes to settings aren't being saved.

Solution:

  1. Check that you have permission to edit site settings.
  2. Verify the value format is correct.
  3. Refresh the page and try again.

Cannot delete site​

Problem: The delete confirmation doesn't work.

Solution:

  1. Type the site name exactly as shown (case-sensitive).
  2. Ensure you have admin permissions.
  3. Check for any pending operations on the site.

Last Updated: January 2025